home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / iso9660 / mail / mh / doc / mh_gen.doc < prev    next >
Encoding:
Text File  |  1992-12-15  |  47.7 KB  |  1,387 lines
  1.  
  2.  
  3.  
  4. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  5.  
  6.  
  7.  
  8. NAME
  9.      mh-gen - generating the MH system
  10.  
  11. READ THIS
  12.      This documentation describes how to configure, generate, and
  13.      install the UCI version of the RAND _M_H system.  Be certain
  14.      to read this document completely before you begin.  You
  15.      probably will also want to familiarize yourself with the _M_H
  16.      Administrator's Guide before you install _M_H.  A copy can be
  17.      found in the file doc/ADMIN.doc is the _M_H sources.
  18.  
  19. DISCLAIMER
  20.      Although the _M_H system was originally developed by the RAND
  21.      Corporation, and is now in the public domain, the RAND Cor-
  22.      poration assumes no responsibility for _M_H or this particular
  23.      modification of _M_H.
  24.  
  25.      In addition, the Regents of the University of California
  26.      issue the following disclaimer in regard to the UCI version
  27.      of _M_H:
  28.           "Although each program has been tested by its contribu-
  29.           tor, no warranty, express or implied, is made by the
  30.           contributor or the University of California, as to the
  31.           accuracy and functioning of the program and related
  32.           program material, nor shall the fact of distribution
  33.           constitute any such warranty, and no responsibility is
  34.           assumed by the contributor or the University of Cali-
  35.           fornia in connection herewith."
  36.  
  37.      This version of _M_H is in the public domain, and as such,
  38.      there are no real restrictions on its use.  The _M_H source
  39.      code and documentation have no licensing restrictions what-
  40.      soever.  As a courtesy, the authors ask only that you pro-
  41.      vide appropriate credit to the RAND Corporation and the
  42.      University of California for having developed the software.
  43.  
  44. GETTING HELP
  45.      _M_H is a software package that is neither supported by the
  46.      RAND Corporation nor the University of California.  However,
  47.      since we do use the software ourselves and plan to continue
  48.      using (and improving) _M_H, bug reports and their associated
  49.      fixes should be reported back to us so that we may include
  50.      them in future releases.  The current computer mailbox for
  51.      _M_H is Bug-MH@ICS.UCI.EDU (in the ARPA Internet), and
  52.      ...!ucbvax!ucivax!bug-mh (UUCP).
  53.  
  54.      Presently, there are two Internet discussion groups,
  55.      MH-Users@ICS.UCI.EDU and MH-Workers@ICS.UCI.EDU.  MH-Workers
  56.      is for people discussing code changes to _M_H.  MH-Users is
  57.      for general discussion about how to use _M_H.  MH-Users is
  58.      bi-directionally gatewayed into USENET as comp.mail.mh.
  59.  
  60.  
  61.  
  62.  
  63. [mh.6]                 Last change: MH.6.8                      1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  71.  
  72.  
  73.  
  74. HOW TO GET MH
  75.      Since you probably already have _M_H, you may not need to read
  76.      this unless you suspect you have an old version.  There are
  77.      two ways to get the latest release:
  78.  
  79.      1.  If you can FTP to the ARPA Internet, use anonymous FTP
  80.      to ftp.ics.uci.edu [128.195.1.1] and retrieve the file
  81.      pub/mh/mh-6.8.tar.Z.  This is a tar image after being run
  82.      through the compress program (approximately 1.8MB).  There
  83.      should also be a README file in that directory which tells
  84.      what the current release of _M_H is, and how to get updates.
  85.  
  86.      This tar file is also available on louie.udel.edu
  87.      [128.175.1.3] in portal/mh-6.8.tar.Z.  You may also find MH
  88.      on various other hosts; to make sure you get the latest ver-
  89.      sion and don't waste your time re-fixing bugs, it's best to
  90.      get it from either ftp.ics.uci.edu or louie.udel.edu.
  91.  
  92.      2.  You can send $75 US to the address below.  This covers
  93.      the cost of a 6250 BPI 9-track magtape, handling, and ship-
  94.      ping.  In addition, you'll get a laser-printed hard-copy of
  95.      the entire MH documentation set.  Be sure to include your
  96.      USPS address with your check.  Checks must be drawn on U.S.
  97.      funds and should be made payable to:
  98.  
  99.                Regents of the University of California
  100.  
  101.      The distribution address is:
  102.  
  103.                Univeristy of California at Irvine
  104.                Office of Academic Computing
  105.                360 Computer Science
  106.                Irvine, CA  92717  USA
  107.  
  108.                +1 714 856 5153
  109.  
  110.      Sadly, if you just want the hard-copies of the documenta-
  111.      tion, you still have to pay the $75.  The tar image has the
  112.      documentation source (the manual is in roff format, but the
  113.      rest are in TeX format).  Postscript formatted versions of
  114.      the TeX papers are available, as are crude tty-conversions
  115.      of those papers.
  116.  
  117. SYNOPSIS
  118.      MAKE
  119.  
  120. DESCRIPTION
  121.      This is a description of how one can bring up an _M_H system.
  122.      It is assumed that you have super-user privileges in order
  123.      to (re-)install _M_H.  Super-user privileges are not required
  124.      to configure or generate _M_H.
  125.  
  126.  
  127.  
  128.  
  129. [mh.6]                 Last change: MH.6.8                      2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  137.  
  138.  
  139.  
  140.      Become the super-user and cd to /usr/src/local/ (or whatever
  141.      you keep your local sources).  The distribution tape con-
  142.      tains the hierarchy for the mh.6-8/ directory.  Bring the
  143.      sources on-line:
  144.  
  145.      # cd /usr/src/local
  146.      % tar xv
  147.      % cd mh-6.8
  148.  
  149. CONFIGURATION
  150.      First, go to the conf/ directory.
  151.  
  152.      % cd conf/
  153.  
  154.      This directory contains files that will produce source files
  155.      tailored for your choice of _M_H configuration.  You should
  156.      edit only the file MH.  This file contains configuration
  157.      directives.  These configuration directives are read by the
  158.      _m_h_c_o_n_f_i_g program to produce customized files.
  159.  
  160.      For examples of various configurations, look in the direc-
  161.      tory conf/examples/.  The file MH provided in conf/ is a
  162.      reasonable default.  Lines beginning with `#' are comments,
  163.      and are not otherwise interpreted.
  164.  
  165.      Here are the _M_H configuration directives available.  Be sure
  166.      to read through this list completely before attempting to
  167.      decide what directives are appropriate for your system.
  168.  
  169.      More information on some of these options is available in
  170.      the the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.  If you do not have a printed
  171.      copy, you should configure your system with the default con-
  172.      figuration file, MH, then generate and print a copy of the
  173.      guide (as described below).
  174.  
  175.   Installation paths
  176.      bin: /usr/local
  177.           The directory where user-invoked programs go (see
  178.           manual section 1).
  179.  
  180.      etc: /usr/local/lib/mh
  181.           The directory where pgm-invoked programs go (see manual
  182.           section 8).
  183.  
  184.      mail: /usr/spool/mail
  185.           The directory where the maildrops are stored.  If this
  186.           pathname is absolute (i.e., begins with a / ), then the
  187.           user's maildrop is a file called $USER in this direc-
  188.           tory.  If the pathname is not absolute, then the user's
  189.           maildrop is in the user's home directory under the
  190.           given name.
  191.  
  192.  
  193.  
  194.  
  195. [mh.6]                 Last change: MH.6.8                      3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  203.  
  204.  
  205.  
  206.      mandir: /usr/man
  207.           The parent directory of the manual entries.
  208.  
  209.      manuals: standard
  210.           Where manual entries should be installed, relative to
  211.           the directory given with "mandir".  Either "local" to
  212.           install manual entries under manl/, or "new" to install
  213.           manual entries under mann/, or "old" to install manual
  214.           entries under mano/, or "standard" to install manual
  215.           entries under man?/, or "gen" to generate but not
  216.           install them, or "none" to neither generate nor install
  217.           them.  For example, to install manual entries under
  218.           /usr/man/u_man/man?, use "standard" and /usr/man/u_man
  219.           for "mandir".
  220.  
  221.      chown: /etc/chown
  222.           The location of the _c_h_o_w_n(8) on your system.  If _c_h_o_w_n
  223.           is in your search path, just use the value of "chown".
  224.           On SYS5 systems, this should probably be "/bin/chown".
  225.  
  226.      cp: cp
  227.           The command to copy files when installing, if not "cp".
  228.           (Some sites use "cp -p".)
  229.  
  230.      ln: ln
  231.           The command to link files together in the source tree,
  232.           if not "ln".  If you're using something like lndir to
  233.           keep your compile tree separate from your source tree,
  234.           set this to "ln -s" or "cp".
  235.  
  236.      remove: mv -f
  237.           How _M_H should make backup copies of existing files when
  238.           installing new files.  To simply remove the old files,
  239.           use "rm -f".
  240.  
  241.   Compiler/loader
  242.      cc: cc
  243.           The name of your C compiler, if not "cc".
  244.  
  245.      ccoptions: -O
  246.           Options given directly to _c_c(1).  The most common is
  247.           "-M" if you're running _M_H on an ALTOS.  This defaults
  248.           to "-O".  If you define this and want to keep "-O", be
  249.           sure to include it explicitly.  If you're using the _G_N_U
  250.           C compiler, it should include `-traditional'.  See
  251.           "options:" for `-D' options.
  252.  
  253.      curses: -lcurses -ltermlib
  254.           This should be the loader option required to load the
  255.           _t_e_r_m_c_a_p(3) and _c_u_r_s_e_s(3) libraries on your system.  On
  256.           SYS5 systems, it probably should be just "-lcurses".
  257.           Some sites have reported that both "-lcurses" and
  258.  
  259.  
  260.  
  261. [mh.6]                 Last change: MH.6.8                      4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  269.  
  270.  
  271.  
  272.           "-ltermlib" are necessary.
  273.  
  274.      ldoptions: -s
  275.           Options given directly to _l_d(1) (via _c_c) at the begin-
  276.           ning of the command line.  Useful for machines which
  277.           require arguments to tell _l_d to increase the stack
  278.           space (e.g. the Gould, which uses "-m 8").  Usually,
  279.           "-s" is a good choice in any event.
  280.  
  281.      ldoptlibs:
  282.           Options given directly to _l_d(1) (via _c_c) at the end of
  283.           the command line.  The two most common are: "-ldbm" if
  284.           you're running MMDF with the _d_b_m package; and, "-lndir"
  285.           if you are generating _M_H on a system which does not
  286.           load the new directory access mechanism by default
  287.           (e.g., 4.1BSD, SYS5).  If you don't have _l_i_b_n_d_i_r on
  288.           your system, the sources are in miscellany/libndir/.
  289.  
  290.      lex: lex -nt
  291.           Alternative version of _l_e_x.  Used in zotnet/tws/.
  292.  
  293.      oldload: off
  294.           This controls how _M_H will try to process library object
  295.           files to eliminate local symbols.  Support for the
  296.           ALTOS loader if "on".  Support for loaders not handling
  297.           `-x -r' correctly if "none".
  298.  
  299.      ranlib: on
  300.           Support for systems with _r_a_n_l_i_b(1).  For SYSTEM 5 sys-
  301.           tems, this should be "off" which tells _M_H to use _l_o_r_d_e_r
  302.           and _t_s_o_r_t instead.  Some SYSTEM 5 sites reported that
  303.           running this isn't always sufficient.  If this is the
  304.           case, then you should edit conf/makefiles/uip to
  305.           include ../sbr/libmh.a and ../zotnet/libzot.a twice in
  306.           the LIBES variable.
  307.  
  308.   Message Transport System
  309.      mts: sendmail
  310.           Which message transport system to use.  Either "mmdf"
  311.           to use _M_M_D_F as the transport system, "mmdf2" to use
  312.           _M_M_D_F-_I_I as the transport system, "sendmail" to have
  313.           _S_e_n_d_M_a_i_l as the transport system, "zmailer" to have
  314.           _Z_M_A_I_L_E_R as the transport system, or, "mh" to have _M_H as
  315.           the transport system.
  316.  
  317.           On UNIX systems supporting TCP/IP networking via sock-
  318.           ets you can add the suffix "/smtp" to the mts setting.
  319.           This often yields a superior interface as _M_H will post
  320.           mail with the local _S_M_T_P server instead of interacting
  321.           directly with _M_M_D_F or _S_e_n_d_M_a_i_l.  Hence, for TCP/IP UNIX
  322.           systems, the "/smtp" suffix to either "sendmail" or
  323.           "mmdf2" is the preferred MTS configuration.  The
  324.  
  325.  
  326.  
  327. [mh.6]                 Last change: MH.6.8                      5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  335.  
  336.  
  337.  
  338.           "/smtp" suffix is described in detail in the
  339.           _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e; be sure to set "servers:" as
  340.           described in _m_h-_t_a_i_l_o_r(8) if you use this option.
  341.  
  342.      mf: off
  343.           Support for mail filtering on those systems in which
  344.           the message transport system isn't integrated with _U_U_C_P
  345.           This option is strictly for an _M_H system using either
  346.           _M_M_D_F-_I as its transport system or one using
  347.           "stand-alone delivery".
  348.  
  349.   UCI BBoards Facility
  350.      bboards: off
  351.           If "on", include support for the UCI BBoards facility.
  352.           BBoards may be enabled with any mts setting.  If "off",
  353.           the BBoard reading program _b_b_c will not be installed.
  354.           If "nntp", include support for the UCI BBoards facility
  355.           to read the Network News via the NNTP.  If "pop" (form-
  356.           erly "popbboards: on"), include support for the UCI
  357.           BBoards facility via the POP3 service; this setting
  358.           requires "pop: on".
  359.  
  360.      bbdelivery: off
  361.           If "off", the BBoards delivery agent and library files
  362.           will not be installed.  If "on", and you set "bboards:"
  363.           to something besides "off", then the BBoards delivery
  364.           agent and library files will be installed in the _b_b_h_o_m_e
  365.           directory (see below).  To read remote BBoards, the
  366.           usual configuration would have _b_b_c talk to a _P_O_P_3 or
  367.           _N_N_T_P server.  However, it may be useful to set this to
  368.           "off" if you NFS mount the _b_b_h_o_m_e directory from
  369.           another host and want to use _b_b_c to read those files
  370.           directly.
  371.  
  372.      bbhome: /usr/spool/bboards
  373.           The home directory for the BBoards user.
  374.  
  375.   Post Office Protocol
  376.      pop: off
  377.           Support for POP service.  This allows local delivery
  378.           for non-local users (a major win).  See
  379.           support/pop/pop.rfc for more information on the POP.
  380.           This option currently works only on UNIX systems with
  381.           TCP/IP sockets.  (It doesn't hurt to enable this option
  382.           regardless of whether or not you intend to use POP.)
  383.           See also "bboards: pop" to enable reading bboards with
  384.           the POP.
  385.  
  386.      popdir: /usr/etc
  387.           The directory where the POP daemon (popd) will be
  388.           installed.
  389.  
  390.  
  391.  
  392.  
  393. [mh.6]                 Last change: MH.6.8                      6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  401.  
  402.  
  403.  
  404.      options:
  405.           `-D' options to _c_c(1).
  406.  
  407.        APOP='"/etc/pop.auth"'
  408.             This option indicates that the POP daemon will sup-
  409.             port the non-standard APOP command, and specifies the
  410.             name of APOP authorization database.  The APOP com-
  411.             mand provides a challenge-based authentication system
  412.             using the MD5 message digest algorithm.  This facil-
  413.             ity is documented in _T_h_e _I_n_t_e_r_n_e_t _M_e_s_s_a_g_e (ISBN
  414.             0-13-092941-7), a book by Marshall T. Rose.
  415.  
  416.             This option also causes the popauth program to be
  417.             installed, which allows the administrator to manipu-
  418.             late the APOP authorization database.  For more
  419.             details, see support/pop/pop-more.txt and the
  420.             _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.
  421.  
  422.        DPOP
  423.             This option indicates that POP subscribers do not
  424.             have entries in the _p_a_s_s_w_d(5) file, and instead have
  425.             their own separate database (a win).
  426.  
  427.        KPOP
  428.             Support for KERBEROS with POP.  This code builds
  429.             _p_o_p_d, _i_n_c and _m_s_g_c_h_k to support only the "kpop" pro-
  430.             tocol.  This code is still experimental, but is
  431.             available for those sites wishing to test it.
  432.  
  433.        MPOP
  434.             This option indicates that the POP daemon will sup-
  435.             port the non-standard XTND SCAN command which pro-
  436.             vides performance enhancements when using the POP
  437.             over low-speed connections.  This option also causes
  438.             an interactive POP client program, popi, to be com-
  439.             piled and installed.  A man page for the popi program
  440.             is also provided.
  441.  
  442.             These extensions are described in _T_h_e _I_n_t_e_r_n_e_t _M_e_s_-
  443.             _s_a_g_e, a book by Marshall T. Rose.  For more details,
  444.             see support/pop/pop-more.txt.  Note: this option
  445.             requires "bboards: pop".
  446.  
  447.        POP2
  448.             Have the POP daemon understand the older POP2 proto-
  449.             col as well as the _M_H POP3 protocol - a major win.
  450.             The POP daemon auto-magically determines which POP
  451.             protocol your client is using.  If you're enabling
  452.             POP service, there's no reason not to enable this
  453.             option as well.  See also _P_O_P_S_E_R_V_I_C_E.
  454.  
  455.        POPSERVICE
  456.  
  457.  
  458.  
  459. [mh.6]                 Last change: MH.6.8                      7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  467.  
  468.  
  469.  
  470.             The port name the _M_H POP will use.  For historical
  471.             reasons, this defaults to "pop".
  472.  
  473.             In 1987, the _M_H POP protocol (POP version 3) was pub-
  474.             lished as RFC1081 and was assigned its own port
  475.             number (110), which differs from the original POP
  476.             (version 1 and 2) port number (109).
  477.  
  478.             To have _M_H POP use the new assigned port number, set
  479.             POPSERVICE='"pop3"', and be sure that this service
  480.             name is listed in your /etc/services file on both POP
  481.             client and server hosts as "110/tcp".  If you enable
  482.             _P_O_P_2, you can safely leave _P_O_P_S_E_R_V_I_C_E undefined
  483.             unless you are using POP3 clients besides _M_H.
  484.  
  485.        RPOP
  486.             This option indicates that support for the UNIX vari-
  487.             ant of POP, RPOP, which uses privileged sockets for
  488.             authentication be enabled.  This peacefully co-exists
  489.             with the standard POP.
  490.  
  491.        SHADOW
  492.             Indicates that the popd POP server can find encrypted
  493.             passwords in the /etc/shadow file (and not in the
  494.             /etc/passwd file).  It should be used only for some
  495.             (newer) SYSTEM 5 systems.
  496.  
  497.          The "APOP" and "MPOP" non-standard POP facilities are
  498.          documented in _T_h_e _I_n_t_e_r_n_e_t _M_e_s_s_a_g_e (ISBN 0-13-092941-7),
  499.          a book by Marshall T. Rose.  For more details, see
  500.          support/pop/pop-more.txt.  The "APOP" option peacefully
  501.          co-exists with the standard POP.  The "MPOP" option
  502.          requires "bboards: pop".
  503.  
  504.  Shared libraries
  505.     sharedlib: off
  506.          If "sun4", makes libmh.a into a SunOS 4.0 (and later)
  507.          shared library.  If you enable this, be sure to also use
  508.          "options SUN40".  If "sys5", makes libmh.a into a SYS5
  509.          R4 (and later) shared library.  If you enable this, be
  510.          sure to also use "options SVR4".
  511.  
  512.     slflags: -pic
  513.          The compiler flags to produce position independent code.
  514.  
  515.     slibdir: /usr/local/lib
  516.          The directory where the _M_H shared library should go.
  517.  
  518.       Under SunOS (sun4)
  519.          Since some _M_H programs are setuid, they'll only look for
  520.          the library in "trusted" locations.  Putting the library
  521.          somewhere besides /usr/lib or /usr/local/lib is not
  522.  
  523.  
  524.  
  525. [mh.6]                 Last change: MH.6.8                      8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  533.  
  534.  
  535.  
  536.          advisable.
  537.  
  538.          If you must do this, be sure that you add the path given
  539.          by slibdir to the compiler's library search list (e.g.,
  540.          "ldoptions: -L/usr/mh/lib") and make sure the path
  541.          starts with a leading `/'.
  542.  
  543.          You may need to run _l_d_c_o_n_f_i_g(8) manually whenever a new
  544.          shared object is installed on the system.  See _l_d(1) for
  545.          more information about using shared libraries.
  546.  
  547.       Under Solaris 2.0 (and newer)
  548.          The above instructions for SunOS apply, except you
  549.          should set the run-time library search path using `-R'
  550.          instead of `-L' (e.g., "ldoptions: -R/usr/mh/lib").
  551.  
  552.  General System Dependencies
  553.     You should include the following directives which are
  554.     appropriate for your version of UNIX.  If you don't know what
  555.     an option does, it probably doesn't apply to you.
  556.  
  557.     mailgroup: off
  558.          If set, _i_n_c is made set-group-id to this group name.
  559.          Some SYS5 systems want this to be set to "mail".  Set
  560.          this if your /usr/spool/mail is not world-writeable.
  561.  
  562.          Note that slocal doesn't know how to deal with this, and
  563.          will not work under these systems; just making it set-
  564.          group-id will open a security hole.  If you're using
  565.          "mailgroup", you should remove slocal (and its man page)
  566.          from your system.
  567.  
  568.     signal: int
  569.          The base type (int or void) of the function
  570.          parameter/return value of _s_i_g_n_a_l(2).  The default is
  571.          int.  Set "signal void" on systems which use this type
  572.          (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).
  573.  
  574.     sprintf: char *
  575.          The return value of the _s_p_r_i_n_t_f library routine.  This
  576.          defaults to "char *".  Set this to "int" if you have an
  577.          older version of SYSTEM 5 which has this routine return
  578.          an "int" type.
  579.  
  580.     options:
  581.          `-D' options to _c_c(1).
  582.  
  583.       ALTOS
  584.            Use on XENIX/v7 systems.  Also, be sure to use
  585.            "options V7".
  586.  
  587.       ATTVIBUG
  588.  
  589.  
  590.  
  591. [mh.6]                 Last change: MH.6.8                      9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  599.  
  600.  
  601.  
  602.            This option causes _M_H to return to the "What now?"
  603.            prompt if your initial editor is vi and it exits with
  604.            non-zero status.  Use on Sun OS 4.1 and other systems
  605.            where the /usr/ucb/vi editor was changed to exit with
  606.            its status equal to the number of pseudo-"errors"
  607.            encountered during the edit.  This causes a problem
  608.            for programs that test the exit status of their editor
  609.            and abort if the status is non-zero.  (This includes
  610.            _M_H and programs like /usr/etc/vipw).
  611.  
  612.       AUX
  613.            Use with AUX systems.
  614.  
  615.       BIND
  616.            If you are running with the BIND code on UNIX systems
  617.            with TCP/IP sockets (e.g. 4.{2,3}BSD), be sure to
  618.            define this.
  619.  
  620.       BSD41A
  621.            Use on 4.1a Berkeley UNIX systems.
  622.  
  623.       BSD42
  624.            Use on Berkeley UNIX systems on or after 4.2BSD.
  625.  
  626.       BSD43
  627.            Use on 4.3 Berkeley UNIX systems.  Also, be sure to
  628.            use "options BSD42".  If _o_p_e_n_l_o_g(3) (see "man 3 sys-
  629.            log") takes three arguments instead of two, and your
  630.            _w_r_i_t_e(1) command is set-group-id to group "tty", use
  631.            this option.  If only one of these conditions is true,
  632.            you lose.
  633.  
  634.       BSD44
  635.            Use on Berkeley UNIX systems on or after 4.4BSD.  This
  636.            code is still under development.
  637.  
  638.       DBMPWD
  639.            Use this option if your _g_e_t_p_w_e_n_t(3) routines read a
  640.            dbm database (such as with Yellow Pages) instead of
  641.            doing a sequential read of /etc/passwd.  Without
  642.            DBMPWD the entire passwd file is read into memory one
  643.            entry at a time for alias expansion.  This is a per-
  644.            formance improvement when reading a standard
  645.            /etc/passwd file, but is _v_e_r_y slow on systems with a
  646.            dbm database.  At one site that runs YP on a large
  647.            passwd file, it showed a 6:1 performance improvement.
  648.  
  649.       FCNTL
  650.            Directs _M_H to use the fcntl() system call for kernel-
  651.            level locking.  If you're using a SYS5 system, you may
  652.            want this option.  (See also `FLOCK' and `LOCKF').
  653.  
  654.  
  655.  
  656.  
  657. [mh.6]                 Last change: MH.6.8                     10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  665.  
  666.  
  667.  
  668.       FLOCK
  669.            Directs _M_H to use the flock() system call for kernel-
  670.            level locking.  If you're on a BSD42 system, and
  671.            you're not using NFS to read or write maildrops, you
  672.            should enable this option.  (See also `FCNTL' and
  673.            `LOCKF').
  674.  
  675.       HESIOD
  676.            Support for HESIOD. This code was contributed, and
  677.            included no documentation.
  678.  
  679.       LOCKF
  680.            Directs _M_H to use the lockf() system call for kernel-
  681.            level locking.  If you're using NFS to read or write
  682.            maildrops, you should enable this option.  (See also
  683.            `FLOCK' and `FCNTL').
  684.  
  685.       locname
  686.            Hard-wires the local name for the host _M_H is running
  687.            on.  For example, locname='"PICKLE"'.  It's probably
  688.            better to either let UNIX tell _M_H this information, or
  689.            to put the information in the host specific mtstailor
  690.            file.
  691.  
  692.       MORE
  693.            Defines  the location of the _m_o_r_e(1) program.  On
  694.            ALTOS and DUAL systems, set MORE='"/usr/bin/more"'.
  695.            The default is "/usr/ucb/more".
  696.  
  697.       NDIR
  698.            For non-Berkeley UNIX systems, this _M_H will try to
  699.            find the new directory access mechanism by looking in
  700.            <ndir.h> if this option is given.  Otherwise, _M_H will
  701.            try <dir.h>.  If you still can't get this to work on
  702.            your system, edit h/local.h as appropriate.  (See also
  703.            `SYS5DIR'.)
  704.  
  705.       NFS
  706.            Tells _M_H to hack around a problem in the NFS C
  707.            library.  If you get an undefined symbol "ruserpass"
  708.            when compiling _M_H, you need this option.  If, however,
  709.            you include this option and get an undefined symbol
  710.            "__ruserpass" when compiling, then you should omit
  711.            this option.
  712.  
  713.       NOIOCTLH
  714.            Tells _M_H not to include the file <sys/ioctl.h>.  To be
  715.            used on systems where this file is not present.
  716.  
  717.       NTOHLSWAP
  718.            Tells _M_H to use the ntohl() macro when processing _m_s_h
  719.            binary map files.  _M_H can use this macro on systems
  720.  
  721.  
  722.  
  723. [mh.6]                 Last change: MH.6.8                     11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  731.  
  732.  
  733.  
  734.            with the include file netinet/in.h, to byte-swap the
  735.            binary information in these map files.  If you're
  736.            using the same map files on machines of different
  737.            architectures, enable this option.
  738.  
  739.       RENAME
  740.            Include this option if your system has a rename()
  741.            library call.  This is true on BSD42 and newer and
  742.            some SYS5 systems.
  743.  
  744.       SENDMAILBUG
  745.            Causes SMTP reply code 451 (failure) to be considered
  746.            the same as code 250 (OK).  Since this might cause
  747.            problems, only enable this if you are certain that
  748.            your SendMail will return this code even when it
  749.            doesn't mean to indicate a failure.
  750.  
  751.       SOCKETS
  752.            Indicates the availability of a socket interface for
  753.            TCP/IP networking that is compatible with 4.{2,3}BSD
  754.            UNIX.  It is not necessary to define this when BSD42
  755.            is already defined, but it might be useful for SYSTEM
  756.            5 or HPUX systems with TCP/IP sockets.
  757.  
  758.       SUN40
  759.            Use on Sun OS 4.0 (and later?) systems.  You also will
  760.            need "options BSD42", "options BSD43", and "signal
  761.            void".
  762.  
  763.            If you're using Sun's brain-damaged approach to offer-
  764.            ing Domain Name Service through NIS, be sure to
  765.            include "options BIND" and "ldoptions -lresolv" to
  766.            work around some NIS/DNS bugs.
  767.  
  768.       SYS5
  769.            Use on AT&T SYSTEM 5 R3 (and newer?) UNIX systems.
  770.            See also _m_a_i_l_g_r_o_u_p.
  771.  
  772.       SYS5DIR
  773.            Define this if your system uses "struct dirent"
  774.            instead of "struct direct".  This is true of System V
  775.            Release 3.0 and later.  Uses include file <dirent.h>
  776.            and the routines _m_k_d_i_r, _r_m_d_i_r and _g_e_t_c_w_d.
  777.  
  778.       SVR4
  779.            Use on AT&T SYSTEM 5 R4 (and newer?) UNIX systems. You
  780.            should also include "options SYS5" and "options
  781.            SYS5DIR".  See also _m_a_i_l_g_r_o_u_p.  You will also need to
  782.            include "oldload none" if your ld doesn't handle
  783.            `-x -r' correctly.
  784.  
  785.       TERMINFO
  786.  
  787.  
  788.  
  789. [mh.6]                 Last change: MH.6.8                     12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  797.  
  798.  
  799.  
  800.            Define TERMINFO if you have it.  You get it automati-
  801.            cally if you're running SYS5, and you don't get it if
  802.            you're not.  (If you're not SYS5, you probably have
  803.            termcap.)
  804.  
  805.       TZNAME
  806.            Use time zone names from the _t_z_n_a_m_e variable, set via
  807.            _t_z_s_e_t.  Only applicable on SYSTEM 5 systems and only
  808.            effective when you have asked for alpha-timezones (see
  809.            the ATZ option).  See also ZONEINFO.
  810.  
  811.       UNISTD
  812.            Include this option if your system has the file
  813.            <unistd.h>.  If not specified, the LOCKF option will
  814.            include <sys/fcntl.h>.
  815.  
  816.       V7
  817.            Use on V7 UNIX systems.  Also, be sure to use "options
  818.            void=int".
  819.  
  820.       VSPRINTF
  821.            Include this option if your system has the _v_s_p_r_i_n_t_f(3)
  822.            library routine; otherwise, __d_o_p_r_n_t(3) will be used.
  823.  
  824.       WAITINT
  825.            BSD42 based systems call the _w_a_i_t(2) system routine
  826.            with a pointer to type _u_n_i_o_n _w_a_i_t.  Include this
  827.            option if you included "options BSD42", but your sys-
  828.            tem calls the _w_a_i_t(2) system routine with a pointer to
  829.            type _i_n_t (the non-BSD42 default).
  830.  
  831.       ZONEINFO
  832.            Specify this if you have a BSD43 based system that
  833.            keeps time zone information /etc/zoneinfo or
  834.            /usr/lib/zoneinfo (SunOS), and where the _s_t_r_u_c_t _t_m
  835.            returned by _l_o_c_a_l_t_i_m_e(3) contains a _t_m__g_m_t_o_f_f element
  836.            (see /usr/include/time.h).  With this fix the GMT
  837.            offset specified in outgoing mail will be corrected
  838.            when the TZ enviornment variable is set to a different
  839.            time zone.  See also TZNAME.
  840.  
  841. Site Preferences
  842.    These options change the default behavior of _M_H or enable
  843.    optional features.  Add the options which are appropriate for
  844.    your configuration or your site preferences.
  845.  
  846.    editor: prompter
  847.         The default editor for _M_H.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855. [mh.6]                 Last change: MH.6.8                     13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  863.  
  864.  
  865.  
  866.    options:
  867.         `-D' options to _c_c(1).
  868.  
  869.      ATZ
  870.           Directs _M_H to use alpha-timezones whenever possible.
  871.           You should not use this option if you are on the Inter-
  872.           net, since it will make your host non-compliant with
  873.           RFC-1123 (Requirements for Internet Hosts).
  874.  
  875.      ATHENA
  876.           Makes _r_e_p_l `-nocc all' the default instead of
  877.           `-cc all'.  You may want to enable this if you're using
  878.           _x_m_h.
  879.  
  880.      BANG
  881.           Directs _M_H to favor `!' over `@' in addressing.
  882.  
  883.      BERK
  884.           Optional for for 4.{2,3}BSD sites running SendMail.
  885.           Disables nearly all of the RFC822 address and header-
  886.           parsing routines in favor of recognizing such formats
  887.           as ASCnet, and so on.  If you don't need to disable the
  888.           parser for this reason, you probably want to use
  889.           "options DUMB" instead.
  890.  
  891.      COMPAT
  892.           If you previously ran a version of _M_H earlier than mh.4
  893.           use this option.  After a short grace period, remove it
  894.           and re-{configure,generate,install} everything.
  895.  
  896.      DUMB
  897.           Directs _M_H not to try and rewrite addresses to their
  898.           "official" form.
  899.  
  900.      FOLDPROT
  901.           Defines the octal value for default folder-protection.
  902.           For example, FOLDPROT='"0700"'.  The default is "0711".
  903.  
  904.      ISI
  905.           When using "repl -ccme", only "cc:" the first address
  906.           found which belongs to the user; any other _A_l_t_e_r_n_a_t_e-
  907.           _M_a_i_l_b_o_x_e_s do not receive "cc:"s.
  908.  
  909.      LINK
  910.           Defines the filename for alternate file name for _d_i_s_t
  911.           and _r_e_p_l.  For example, LINK='"\\043"' to use the
  912.           pound-sign character.  The default is "@".
  913.  
  914.      MHE
  915.           Enables crude support for Brien Reid's MHE interface.
  916.           Recommended for use with the GNU Emacs mh-e package.
  917.  
  918.  
  919.  
  920.  
  921. [mh.6]                 Last change: MH.6.8                     14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  929.  
  930.  
  931.  
  932.      MHRC
  933.           Enables _M_H to recognize the _C_S_h_e_l_l's `~'-construct.
  934.           This is useful for sites that run with a ~/.mhrc for
  935.           their users.
  936.  
  937.      MIME
  938.           Enables support for multi-media messages, as specified
  939.           in RFC 1341 -- a major win.  This allows you to include
  940.           things like audio, graphics, and the like, in your mail
  941.           messages.  Several _M_H commands are extended to support
  942.           these multi-media messages, and the _m_h_n command is pro-
  943.           vided to encode and decode MIME messages.  For more
  944.           details, see miscellany/multi-media/READ-ME and _m_h_n(1).
  945.  
  946.      MSGID
  947.           Enables slocal to detect and surpress duplicate mes-
  948.           sages received.  This code uses the <ndbm.h> library,
  949.           and requires "options BSD42" since it uses the _f_l_o_c_k(2)
  950.           system call for locking.  (Note that this means its
  951.           database locking does not work over NFS.) It has only
  952.           been tested under SUN40.
  953.  
  954.      MSGPROT
  955.           Defines the octal value for default folder-protection.
  956.           For example, MSGPROT='"0600"'.  The default is "0644".
  957.  
  958.      NOMHSEQ
  959.           Directs _M_H to make private sequences the default.
  960.  
  961.      OVERHEAD
  962.           Enable _M_H commands to read profile/context from open
  963.           fd:s without doing an open(); see _m_h-_p_r_o_f_i_l_e(5) for the
  964.           details.
  965.  
  966.      RPATHS
  967.           Directs _i_n_c to note UNIX "From " lines as Return-Path:
  968.           info.
  969.  
  970.      SBACKUP
  971.           Defines the prefix string for backup file names.  For
  972.           example, SBACKUP='"\\043"'.  The default is ",".
  973.  
  974.      TMA
  975.           Support for the TTI _t_r_u_s_t_e_d _m_a_i_l _a_g_e_n_t (TMA).  Although
  976.           the TTI TMA is not in the public domain, the _M_H support
  977.           for the TTI TMA is in the public domain.  You should
  978.           enable this option only if you are licensed to run the
  979.           TMA software (otherwise, you don't have the software in
  980.           your _M_H source tree).
  981.  
  982.      TTYD
  983.           Support for TTYD.  This is no longer in wide use, and
  984.  
  985.  
  986.  
  987. [mh.6]                 Last change: MH.6.8                     15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  995.  
  996.  
  997.  
  998.           is not recommended.
  999.  
  1000.      UCI
  1001.           First, "_" and "#" are recognized as the prefixes for
  1002.           scratch files.  Second, support for the UCI
  1003.           group-leadership mechanism is enabled in _c_o_n_f_l_i_c_t.
  1004.           Third, the first line of the file file $HOME/.signature
  1005.           is used as the _F_u_l_l _N_a_m_e part of your "From:" header.
  1006.           This may conflict with the interpretation of this file
  1007.           by _N_e_w_s.  If you're not at UCI, you probably don't want
  1008.           this option.
  1009.  
  1010.      UK
  1011.           Directs the _s_c_a_n program to generate UK-style dates by
  1012.           default.
  1013.  
  1014.      WHATNOW
  1015.           Enable certain _M_H commands to act differently when
  1016.           $mhdraft set.
  1017.  
  1018.      YEARMOD
  1019.           This option makes the _m_h-_f_o_r_m_a_t %(year) function always
  1020.           return a value less than 100.  Enable this option if
  1021.           you have local _m_h-_f_o_r_m_a_t(5) files which cannot handle
  1022.           4-digit years.  You should convert these files to use a
  1023.           4-character field width, or use the %(modulo 100) func-
  1024.           tion to obtain a 2-digit year value.  After a short
  1025.           grace period, remove `YEARMOD' and re-
  1026.           {configure,generate,install} everything.
  1027.  
  1028. Testing/debugging
  1029.   debug: off
  1030.        Support for debug mode of _M_H.  Don't use this unless you
  1031.        know what you're doing, which isn't likely if you're read-
  1032.        ing this document!
  1033.  
  1034.   regtest: off
  1035.        Set this to "on" if you are doing regression testing among
  1036.        different compilations of _M_H, and you do not want the
  1037.        hostname and compile date included in _M_H binaries.
  1038.  
  1039.  
  1040.  
  1041.      Now edit conf/config/mtstailor, depending on your choice of
  1042.      the setting for mts in the _M_H configuration file.  for an
  1043.      mts setting of "mh", look at the file conf/tailor/mhmts; for
  1044.      an mts setting of "sendmail", "sendmail/smtp", "mmdf/smtp",
  1045.      or "mmdf2/smtp", look at the file conf/tailor/sendmts; and,
  1046.      for an mts setting of "mmdf", or  "mmdf2", look at the file
  1047.      conf/tailor/mmdf.
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053. [mh.6]                 Last change: MH.6.8                     16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  1061.  
  1062.  
  1063.  
  1064.      Now install the configured files into the source areas.  (On
  1065.      SYS5 systems, or other systems where you get complaints
  1066.      about "_index" and "_rindex" being undefined, you should use
  1067.      "make sys5" to compile mhconfig.)
  1068.  
  1069.      % make
  1070.      % ./mhconfig MH
  1071.  
  1072.      Before proceeding, you should familiarize yourself with the
  1073.      _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.  To generate an _n_r_o_f_f version, go to
  1074.      the doc/ directory and type:
  1075.  
  1076.      % (cd ../doc/; make ADMIN.doc)
  1077.  
  1078.  
  1079.      If you're already running _M_H at your site, you should also
  1080.      read the _m_h changes document CHANGES.  The source is in
  1081.      papers/changes/.
  1082.  
  1083.      After reading the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e, you may decide to
  1084.      change your MH configuration.  If so, cd back to the conf/
  1085.      directory, re-edit the file MH, and re-run _m_h_c_o_n_f_i_g.
  1086.  
  1087.      You now proceed based on your choice of a transport system
  1088.      (the setting for mts above).  The best interface is achieved
  1089.      with "sendmail" followed by "mmdf" or ("mmdf2"), and then
  1090.      "mh" (stand-alone delivery, not recommended).
  1091.  
  1092.   SENDMAIL
  1093.      If you have not enabled BBoards or POP then no further
  1094.      MTS-specific action is required on your part!
  1095.  
  1096.      If you have enabled POP, but you want to let _S_e_n_d_M_a_i_l
  1097.      deliver mail POP mail using its standard delivery program
  1098.      /bin/mail, then, again, no further MTS-specific action is
  1099.      required on your part!
  1100.  
  1101.      Otherwise, go to the mts/sendmail/ directory.
  1102.  
  1103.      % cd ../mts/sendmail/
  1104.  
  1105.      This directory contains files whose definitions correspond
  1106.      to the configuration of your _S_e_n_d_M_a_i_l system.  If you have
  1107.      enabled BBoards or POP service, then you will need to
  1108.      re-configure _S_e_n_d_M_a_i_l.  First, in the "local info" section
  1109.      of your site's _S_e_n_d_M_a_i_l configuration file, choose a free
  1110.      macro/class (B is used in this distribution), and add these
  1111.      lines:
  1112.  
  1113.           # BBoards support
  1114.           DBbboards
  1115.           CBbboards
  1116.  
  1117.  
  1118.  
  1119. [mh.6]                 Last change: MH.6.8                     17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  1127.  
  1128.  
  1129.  
  1130.      Second, immediately after the inclusion of the zerobase
  1131.      file, in the "machine dependent part of ruleset zero" sec-
  1132.      tion, add these lines:
  1133.  
  1134.           # resolve names for the BBoards system
  1135.           R$+<@$=B>      $#bboards$@$2$:$1        topic@bboards
  1136.  
  1137.      Be sure to use tabs when separating these fields.  Third,
  1138.      add the line
  1139.  
  1140.           include(bboardsMH.m4)
  1141.  
  1142.      after the line
  1143.  
  1144.           include(localm.m4)
  1145.  
  1146.      in your site's _S_e_n_d_M_a_i_l configuration file.  Finally, you
  1147.      should link the file mts/sendmail/bboardsMH.m4 into your
  1148.      _S_e_n_d_M_a_i_l cf/ directory and re-configure _S_e_n_d_M_a_i_l.
  1149.  
  1150.      If you have enabled POP service, a similar procedure must be
  1151.      used on the POP service host, to re-configure _S_e_n_d_M_a_i_l.
  1152.      First, in the "local info" section of your site's _S_e_n_d_M_a_i_l
  1153.      configuration file, choose a free macro/class (P is used in
  1154.      this distribution), and add these lines:
  1155.  
  1156.           # POP support
  1157.           DPpop
  1158.           CPpop
  1159.  
  1160.      Second, immediately after the inclusion of the zerobase
  1161.      file, in the "machine dependent part of ruleset zero" sec-
  1162.      tion, add these lines:
  1163.  
  1164.           # resolve names for the POP system
  1165.           R$+<@$=P>      $#pop$@$2$:$1            subscriber@pop
  1166.  
  1167.      Be sure to use tabs when separating these fields.  Third,
  1168.      add the line
  1169.  
  1170.           include(popMH.m4)
  1171.  
  1172.      after the line
  1173.  
  1174.           include(localm.m4)
  1175.  
  1176.      in your site's _S_e_n_d_M_a_i_l configuration file.  Finally, you
  1177.      should link the file mts/sendmail/popMH.m4 into your _S_e_n_d_-
  1178.      _M_a_i_l cf/ directory and re-configure _S_e_n_d_M_a_i_l.
  1179.  
  1180.   MMDF
  1181.      If you want _M_M_D_F to be your transport service, and have NOT
  1182.  
  1183.  
  1184.  
  1185. [mh.6]                 Last change: MH.6.8                     18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  1193.  
  1194.  
  1195.  
  1196.      specified "mmdf/smtp" (or "mmdf2/smtp") as your mts setting,
  1197.      then go to the mmdf/ directory.  (If you're using
  1198.      "mmdf/smtp" or "mmdf2/smtp" as your mts setting, then skip
  1199.      to the next section.)
  1200.  
  1201.      % cd ../mts/mmdf/
  1202.  
  1203.      This directory contains files whose definitions correspond
  1204.      to the configuration of your _M_M_D_F system.
  1205.  
  1206.      If you're running _M_M_D_F-_I, then copy the following files from
  1207.      wherever you keep the _M_M_D_F sources to this directory:
  1208.      mmdf/h/ch.h, mmdf/h/conf.h, utildir/conf_util.h,
  1209.      utildir/ll_log.h, mmdf/h/mmdf.h, utildir/util.h,
  1210.      mmdf/mmdf_lib.a, and utildir/util_lib.a.
  1211.  
  1212.      If you're running _M_M_D_F-_I_I, then copy the following files
  1213.      from where you keep the _M_M_D_F sources to this directory:
  1214.      h/ch.h, h/conf.h, h/dm.h, h/ll_log.h, h/mmdf.h, h/util.h,
  1215.      and lib/libmmdf.a
  1216.  
  1217.      If you have enabled bboards, then the directories
  1218.      support/bboards/mmdfI and support/bboards/mmdfII contain
  1219.      information you'll need to put a UCI BBoards channel in your
  1220.      _M_M_D_F configuration.  Similarly, if you have enabled option
  1221.      "mf" and are running _M_M_D_F-_I, then the zotnet/mf/mmdfI/
  1222.      directory contains information you'll need to put a _U_U_C_P
  1223.      channel in your _M_M_D_F-_I configuration.  Finally, the direc-
  1224.      tory support/pop/mmdfII contains information you'll need to
  1225.      put a POP channel in your _M_M_D_F-_I_I configuration.
  1226.  
  1227.      Note that _M_M_D_F-_I_I is distributed with the BBoards channel,
  1228.      although the version in the _M_H distribution might be more
  1229.      current, the version in the _M_M_D_F-_I_I distribution has been
  1230.      tested with that revision of _M_M_D_F.
  1231.  
  1232.   MMDF/SMTP
  1233.      If you are using "mmdf/smtp" as your mts setting, then no
  1234.      further MTS-specific action is required on your part!
  1235.  
  1236.   MMDF2/SMTP
  1237.      If you are using "mmdf2/smtp" as your mts setting, then no
  1238.      further MTS-specific action is required on your part!
  1239.  
  1240.   STAND-ALONE DELIVERY
  1241.      If, instead, you want _M_H to handle its own mail delivery,
  1242.      then no further MTS-specific action is required on your
  1243.      part!
  1244.  
  1245. GENERATION
  1246.      Go to the _M_H top-level directory and generate the system.
  1247.  
  1248.  
  1249.  
  1250.  
  1251. [mh.6]                 Last change: MH.6.8                     19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  1259.  
  1260.  
  1261.  
  1262.      % cd ../; make
  1263.  
  1264.      This will cause a complete generation of the _M_H system.  If
  1265.      all goes well, proceed with installation.  If not, complain,
  1266.      as there "should be no problems" at this step.
  1267.  
  1268. INSTALLATION
  1269.      If the directories you chose for the user-programs and
  1270.      support-programs ("bin" and "etc" in the conf/MH file) don't
  1271.      exist, you should create them at this point.
  1272.  
  1273.      Next, if you enabled support for the UCI BBoards facility,
  1274.      then create a login called "bboards" with the following
  1275.      characteristics: home directory is /usr/spool/bboards/ with
  1276.      mode 755 (actually, use the value for "bbhome" given in the
  1277.      _M_H configuration file), login shell is /bin/csh (or
  1278.      /bin/sh), and, encrypted password field is "*".  The
  1279.      "bboards" login should own the /usr/spool/bboards/ direc-
  1280.      tory.  In addition to creating /usr/spool/bboards/, also
  1281.      create /usr/spool/bboards/etc/ and
  1282.      /usr/spool/bboards/archive/.  These directories should also
  1283.      be owned by the "bboards" login.
  1284.  
  1285.      If you enabled support for POP, then on the POP service
  1286.      host, create a login called "pop" with the following charac-
  1287.      teristics: home directory is /usr/spool/pop/ with mode 755,
  1288.      login shell is /bin/csh, and, encrypted password field is
  1289.      "*".  If you don't have /bin/csh on your system (V7), then
  1290.      /bin/sh is just fine.  The "pop" login should own the
  1291.      /usr/spool/pop/ directory.  You'll also need to add a line
  1292.      to the /etc/services file and the /etc/rc.local file, see
  1293.      the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e  for more details.
  1294.  
  1295.      If this is not the first time you have installed _M_H, these
  1296.      files will need particular attention:
  1297.  
  1298.           _D_i_r_e_c_t_o_r_y                 _F_i_l_e_s
  1299.           "etc/"                    MailAliases, BBoardAliases, mtstailor
  1300.           /usr/spool/bboards/       BBoards, .cshrc, .mh_profile
  1301.           /usr/spool/bboards/etc/   *
  1302.  
  1303.      The MailAliases, BBoardAliases, mtstailor and BBoards files
  1304.      will NOT be installed over existing copies; you will need to
  1305.      edit these by hand and merge in any changes from your previ-
  1306.      ous _M_H release.  The other files under /usr/spool/bboards/
  1307.      will be overwritten if they exist.  You may wish to preserve
  1308.      your old versions of these before installing _M_H.
  1309.  
  1310.      As the super-user, and from the mh.6/ directory, install the
  1311.      system.
  1312.  
  1313.      # make inst-all
  1314.  
  1315.  
  1316.  
  1317. [mh.6]                 Last change: MH.6.8                     20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. MH-GEN(8)             MAINTENANCE COMMANDS              MH-GEN(8)
  1325.  
  1326.  
  1327.  
  1328.      This will cause the _M_H processes and files to be transferred
  1329.      to the appropriate areas with the appropriate attributes.
  1330.  
  1331. TAILORING
  1332.      See the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e for information on tailoring
  1333.      _M_H for the MTS, BBoards, and POP.
  1334.  
  1335. DOCUMENTATION
  1336.      In addition to this document, the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e, and
  1337.      the _U_s_e_r'_s _M_a_n_u_a_l, there are several documents referenced by
  1338.      the user's manual which may be useful.  The sources for all
  1339.      of these can be found under the papers/ directory.
  1340.  
  1341. OTHER THINGS
  1342.      Consult the directory miscellany/ for the sources to a
  1343.      number of things which aren't part of the mainstream _M_H dis-
  1344.      tribution, but which are still quite useful.
  1345.  
  1346. FILES
  1347.      Too numerous to mention.  Really.
  1348.  
  1349. SEE ALSO
  1350.      make(1)
  1351.  
  1352. BUGS
  1353.      The _m_h_c_o_n_f_i_g program should be smarter.
  1354.  
  1355.      There's no way to print the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e until
  1356.      after you have configured the system; it is difficult to
  1357.      configure the system without the _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.
  1358.  
  1359.      The Makefiles should know when _m_h_c_o_n_f_i_g has been run and
  1360.      force "make clean" behavior.
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383. [mh.6]                 Last change: MH.6.8                     21
  1384.  
  1385.  
  1386.  
  1387.